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Abstract 

A beam physics model server (Art++) has been developed 
for the Jefferson Lab accelerator. This online model server 
is a redesign of the ARTEMIS model server The need 
arose from an impedance mismatch between the current 
requirements and ARTEMIS capabilities. The purpose of 
the model server is to grant access to both static (machine 
lattice parameters) and dynamic (actual machine settings) 
data using a single programming interface. A set of useful 
optics calculations (R-matrix, orbit fit, etc.) has also been 
implemented and can be invoked by clients via the model 
interface. Clients may also register their own dynamic 
models in the server The server interacts with clients us- 
ing the CDEV protocol and data integrity is guaranteed by 
a relational database (OracleSi) accessed through a persis- 
tence layer By providing a centralized repository for both 
data and optics calculations, the following benefits were 
achieved: optimal use of network consumption, software 
reuse, and ease of maintenance. 

1 INTRODUCTION 

The CEBAF accelerator is a 6 GeV, 5 pass, continuous 
beam electron recirculating linac [^. The two supercon- 
ducting linacs are joined head to tail by beam transport 
systems. The beam can be extracted during any of the five 
passes and delivered to three experimental halls. The pur- 
pose of ArtH-H- is to provide an accurate and timely repre- 
sentation of the machine for high level applications such as 
the fast feedback system [|]] or the automated beam steering 
system [^. As such, Art-H- serves as a central repository 
for beam physics calculations (twiss functions, R-matrix, 
trajectories, etc.) and facilitates access to the set of pa- 
rameters characterizing any beam element. By centralizing 
the source of information and beam physics algorithms, we 
leverage beam physics expertise and our knowledge of ma- 
chine parameters. 

2 ARCHITECTURE 

Art-H- is a distributed system, utilizing CDEV as its 
underlying protocol. The software architecture is object- 
oriented, written in C++, and is organized in modules as 
shown in figure |l} Each module is decoupled from the oth- 
ers and accessed only by means of a well defined interface. 
The core module encompasses the business logic pertinent 
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Figure 1 : Art-H- physical view. 

to the modeling of the accelerator. The server module re- 
lies on CDEV protocol to interact with clients exposing a 
number of interfaces for the clients to act upon. The API 
Pack module contains a number of parser classes to in- 
terface with external data sources. The persistence layer 
provides database functionalities to the core module. Cur- 
rently, the supported database mechanisms are relational 
database tables, implemented in Oracle, and flat files. 

2. 1 Core package 

The core package encompasses all the classes directly re- 
lated to the problem domain. The class hierarchy shown 
in figure ^ is closely matched to the real accelerator struc- 
ture. A model class holds a set of beam segments; each 
segment contains a set of generic beam elements. More 
specialized versions of the beam element class embody op- 
tical concepts such as quadrupoles, dipoles, drift sections, 
etc. 

The segmentation of the beam line is shown in figure 
^ Points of segmentation fall naturally at the beginning of 
each beam transport section delineated by the separation or 
recombination parts. 
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Figure 2: Art++ class hierarchy. 



Harp 



2. 2 API Pack package. 

Interfacing with external data sources is accomplished 
by the API Pack package. It contains various parser classes 
to read machine descriptions and currently supports only 
the Optim[H and twiss input files. Its framework can eas- 
ily be extended to deal with other formats. The accelerator 
lattice is specified by an xml configuration file which 
describes the beamline segmentation. Here is a typical con- 
figuration file for a short stretch of the machine, namely the 
injector and the first arc: 
<model> 

<lattice name= ' CEBAF ' > 

<section name='INJ' energy='5.01268'> 

<optf ile>inj _nlp . opt</optf ile> 

<twissf ile>inj _nlp . twiss</twissf ile> 

</section> 

<section name='ARCl' energy='MMSARClE'> 

<optf ile>arclp. opt</optf ile> 

<twissf ile>arclp. twiss</twissf ile> 

</section> 

</lattice> 

<layout> 

<pass number='l'> 

<section>INJ </section> 

<section>ARCl</section> 

</pass> 

</layout> 

</model> 

Each segment is defined by its name and corresponding 
Optim and twiss files that provide all the static parameters 
needed by the model. We will refer to this set of data as the 
"design" model in the rest of this paper 

2.3 Server package 

The server package adapts the CDEV server interface to 
the internals of Art-n-. It retrieves incoming messages, dis- 
patching them to relevant server methods and sending re- 
sults back to the clients. 

2.4 TCL-CDEV interface 

Art-H- can be queried via the TCL scripting language and 
TCL-CDEV extension ||8} . The use of TCL scripting lan- 
guage facilitates rapid prototyping [^] of new applications. 
It can also be used for simple situations where performance 
is not a stringent requirement. 

2.5 API 

Alternatively, Art-H- can be accessed via an API provided 
by a C compatible shared library. We chose not to make it 
a C++ library with exported classes because of the need to 
support legacy applications written in C. This API allows 
any user of the control system to write thin-client appli- 
cations making full use of the model server By utilizing 
CDEV as the underlying protocol, users can develop dis- 
tributed applications with minimal effort. 



2.6 Persistence layer 

The role of the persistence layer [ pO| ] is to encapsulate ac- 
cess to the database, so that details about database table lay- 
out and corresponding SQL or OCI (Oracle Call Interface) 
query mechanisms need not be coded into the application. 
With the persistence layer in place the database can be re- 
organized and the data access routines tuned without any 
modification to the application itself. The persistence layer 
uses a data dictionary to allow mapping application objects 
to relational database tables and rows Jill]. Although it 
might seem natural to use an object-oriented database to 
avoid such object-to-relational mapping, we decided the 
effort of translation was worthwhile because information 
stored in a relational database will be more accessible and 
easier to maintain. Information that needs to be updated 
often, such as beamline survey data or magnet field prop- 
erties, can be maintained by simple scripts written by other 
staff. 

3 BEAM PHYSICS COMPUTATIONS 

ArtH-H- provides availability to the following: 

• Generation of first order matrices. 

• Calculation of twiss parameters. 

• Evaluation of transfer matrices at first order. 

• Correct treatment of the acceleration process in the 
linac including adiabatic damping and cavity fo- 
cussing effects. 

• Determination of orbits. 

All Art-H- computations are carried out at first order. 
Transfer matrices are computed by using twiss parameters 
instead of the alternative approach that calculates the prod- 
uct of all the matrices. This procedure results in an 0(1) 
performance in transfer matrix evaluation. 

4 ONLINE REALTIME MODEL 

To establish an accurate view of the machine, it is neces- 
sary to track changes in the beamline in realtime. The dy- 
namic parameters for each dipole, quadrupole and cavity 
are monitored. Whenever one such element changes, its 
local transfer matrix is recomputed and the twiss param- 
eters recalculated by forward propagation from that point 
onward to the end of the segment. As in the case of the de- 
sign model, the realtime model evaluates transfer matrices 
using twiss parameters. 

5 HIGH LEVEL APPLICATIONS 

Several high-level applications are using or being modified 
to use Art-H-: 




Figure 3: CEBAF accelerator lattice segmentation. 



• Autosteer [Q| is a multi-pass orbit correction steering 
algorithm used at Jefferson Lab to steer the machine. 
Autosteer determines the optimal corrector settings to 
minimize beam displacement. It utilizes Art++ to re- 
trieve transfer matrices between beam position moni- 
tors and correctors. 

• Automatch | jl2[ | performs beam envelope matching 
between the transport segments. It requires knowl- 
edge of the twiss parameters for the filling sections. 
ArtH-H- computes these twiss parameters in realtime for 
use by Automatch. 

• The fast feedback control program [^j] corrects the 
beam position and energy disturbances using a con- 
trol loop based on a linear quadratic gaussian con- 
troller/estimator. ArtH-H- will be utilized by the fast 
feedback system in its setup phase to retrieve twiss 
functions for various elements. 

We plan to port all the high level applications to this new 
model server. Preliminary testing of the server was carried 
out concurently with the testing of Automatch. The first re- 
sults show that the server behaves as expected. It exhibits a 
dramatic performance increase over Artemis, utilizing only 
a fraction of the model server CPU time (5 % versus 80 % 
for Artemis). 
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